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1.0 PREFACE 


The Linker is a post compilation utility by which input object 
text is processed and written to various “hardware* segment files 
which can then be loaded on the SES CYBER 180 Simulator. The 
different object text records in a particular section are 
processed to form a set cf hardware segment images. Data in the 
different segments is orimarity referenced via pointers set up in 
the Binding segment which is initiatized at Link time. 
Unsatisfied externais are satisfied from the specified 
libraries. 


Users have the option of supplying the input via an object 
file (nith/uithout 1 ibrary fites) as generated by the 
compiter/assembler, or else (s)he may specify an entry point from 
a modute on a specified iibrary as the PEP parameter on the LINK 
commands, and the Linker wilt extract the module from the tibrary 
which contains the specified entry point and link it. 


The input to the Linker consists of CYBER 180 {C180) object 
modules in CYBER 180 jtloader text format V1ie1 generated by 
compilers and/or assembiers running on CYBER 170. 


The outout of the Linker is a series of files corresponding to 
CYBER 180 hardware segqments$ a header file which contains the 
segment descriptor attributes for each output segments and 
potentially an outboard symbol! table file. 


Currentiys, the only mechanism available for takings Linker 
output and preparing it for execution in the CYBER 180 Simutator 
is the Virtual Environment Generator. It will take the segment 
files produced by the VE Linkers and buitd a Checkpoint File 
(CPF). 


1ei SCOPE 


This document describes the external characteristics of the 
SES Virtual Environment Linker V2.5. The Linker is written in 
CYBIL. 

This Linker is strictly intended as a transitional vehicie 
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from CYBER i70/S5ES to CYBER 180. It will not nave a lifetime 
beyond the period of transition. 
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1.2 APPLICABLE DOCUMENTS 


The foltowing is a list of documents that either are referred 
to in this specification or are recommended to aid in 
understanding and using this specification. 


1) SES User’s Handbook (ARH 1833). 

2) ERS for Virtua! Environment Generator (ARH2591). 

3) CYBER 1808 Mainframe Mcdet Independent GDS (ARH 1700). 
4&4) ERS for Simulated NOS/VE I/0 (ARH3125). 

5) ERS for CYBER 180 Object Code Utitities (ARH 2922). 
6) ERS for CYBER 180 Simulator (ARH 1729). 
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i103 LINKER V2.5 AND LINKER V2.4 DIFFERENCES 


1) Tne LINKER has been converted to CYBIL compiler ianguace. 
2) Updated to process Viet of the 189 Object Text. 


3) Interface to the SES subsystem thas been replaced with an 
internal liinker parameter file. 
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1.4 DEFICTENCTES ANDO LIMITATIONS 


The Linker performs onty cursory checks to determine if the 
user has specified any duplicate file names in his/her 
parameterization. 


The Linker performs no checks to determine if any file names 
generated from the NAME_SEED dunticate any file names the user 
has specified in his/her carameterization. Therefore, the Linker 
may abort oor yield indeterminate results. Hence, the user must 
resolve any file naming conflicts prior to executing the LINKER 
command. 


The Linker is sensitive to portions of the data on an object 
file. It uses some of the data for computations. Therefore, iif 
an object file was generated by other than PASCAL-CI or the CYBER 
180 Assembler; or modified with other than the CYBER 180 Object 
File Utitities, the Linker may abort or yield indeterminate 
results. 
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1.5 TERMINOLOGY 


Offset tinking? An optional mode of tinking wherein the segments 
output by the Linker are to be toaded at addresses that are 
different than the addresses at which they will uttimately 
execute. 


Inboard symbol! tabte: A tabte of resolved entry points from a 
previous linkage provided as input to the current linkage. 
Use of the inboard symbol table allows the linkage of only a 
part of the code that will actuality be present when the code 
is executed. 


Outboard symbol tabie? A table of resoitved entry points produced 
by the current linkage for inciusion in future tinkages. 
Oniy entry points from modules possessing the “gated” 
attribute are inciuded in the outboard symbol tabte. Use of 
the outboard symbo! tabte ailows entry definitions from the 
current finkage to be used in subsequent tinkages without 
relinking the modutes in which the entry points are defined. 
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220 ACCESSING THE LINKER 


The Linker is accessed via an SES procedure, which is 
described in a later sections. The user can control the linkase 
by specifying his parameters on the procedure call, {GENCPF or 
VELINK)», in the Linker Parameter File, or a combination of both. 
Parameters on the procedure call override the parameters 
specified in the Parameter File. 
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LINKER PARAMETER FILE (LPF) 


The Linker Parameter File (LPF) consists of a legible file built 
and maintained by an editor. tLtPF is an optional parameter to the 
LINK command. If one is not provided, defaults are as shown 
below. Several “subcommands™ will be provideds LINK_OPTIGNS, 
OBJECT_FILE. OBJECT_LIBRARY, DEFINE SEGMENT, OBJEC T_MODULE » 
INBOARD_SYMBOL_TABLE and END. Each subcommand is entered on a 
separate fine; however, continuation tines of a subcommand are 
indicated by piacing two or more periods at the end of the tlinee 


LINK OPTIONS 


The LINK_OPTIONS command provides general miscetianeous 
parameters which estabtish defaults for the LINK command. Oniy 
one LINK_OPTIONS command is altowed. 


LINK _OPTIONS,&MAP_FILENAME=filename ,&.. 
MAP_OPTIONS=map_option »&REWIND_ MAP, &NAME_SEED=name_seedshee 
MAX_EXTERNALS=maximum_externais, &HEAP_SIZE=heap_sizes&.. 
PRIMARY_ENTRY_PT=orimary_entry_point 


FIELD 
DEFAULT DESCRIPTION 
MAP_FILENAME (CHAR 7) The NOS filename of the LINKER output 
LINKMAP listing file on which the LINKER map will be 
written. This parameter is ignored if the MF 
(map file) parameter is specified on tre LINK 
commande 
MAP_OPTIONS ({CHfR 1) The Linker map options which control 
M the amcunt of information cufput on the Linker 


Mape Values for this field ares’ 
N =- no map informatior$; diaanostics are 
output. 
$ - section allocations for every section 
of every input object module 
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REWIND_MAP 
REWIND MAP 


NAME_SEED 
SEGM 


MAX_EXTERNALS 
300 
HEAPSIZE 
0 


LOAD_SEGMENT 
4095 


EXECUTE_SEGMENT 
4095 


PRIMARY_ENTRY_PT 
blanks 


E - Section aliocations pius entry point 
names and address assignments 
M = Section aliocations, entry points 
plus output segment and common block 
allocations (full Linker map). 
(KEYWORD) The option allowing you to snecify 
whether to rewind the LINKER map file before 
it is written. 
REWIND _MAP = rewind map file 
NO_MAP_LREWIND - don‘t rewind map file 
(CHAR 4) Used as the first four characters of 
of the NOS file names for the header file, 
output segments, and outboard symboi table 
file. This field is ignored if the name_seed 
parameter is specified on the VELINK commande 
{INTEGER) The maximum number of externais 
aliowed in this link. 
(INTEGER) The size in bytes of the system 
heap. IF specifieds this value atways takes 
precedence over the vaiues specified in the 
input cbject modules. 
(INTEGER) The starting segment number for toad 
foad address. The linker allocates segment 
numbers consecutively. 
(INTEGER) The starting segment number for 
execution_address. The Linker allocates 
segment numbers consecutively. If either but 
not both LOAD_SEGMENT and EXECUTE_SEGMENT are 
specified, offset foading will not be 
performede A null specification for 
LOAD_SEGMENT or EXECUTE_SEGMENT is indicated 
by a value of 4095. 
(CHAR 31) Primary entry point of the program 
being tinked. If specified, it overides atl 
transfer symbols encountered in the input 
object modules. This parameter is ignored if 
the PEP parameter is used on the LINK 
commande If not specified here or on the 
command, the first transfer symbol enccuntered 
is the primary entry point. 
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OBJECT FILE /OBJECT LIBRARY 


One OBJECT_FILE command exists for each specified object file 
entry, and one OBJECT_LIBRARY command exists for each specified 
{ibrary entry. VELINK command parameters °OFL* and ‘“LFL* take 
precedence over these commands. 


OBJECT_LFILE., FILENAME=filename, Ri=ring, R2=rings a 
R3=ring, GLOBAL_LOCAL_KEY=key, EXECUTE_PRIVILEGE=-attribute 


OBJECT_LIBRARY, FILENAME=filename, Ri=ring, R2=rings «+ 
R3=ring, GLOBAL_LOCAL_KEY=key, EXECUTE_PRIVILEGE=attribute 


FIELD 
DEFAULT DESCRIPTION 
FILENAME {CHAR 7) NOS” file that name of a tocal file 
that 
none contains object modules. 
Ri il . {INTEGER) The ring bracket to be used for all 
R2 i411 object modules contained on this fite. 
R3 11 / 
GLOBAL_LOCAL_KEY CINTEGER) The gtobal and tocal key valves 
0 to be used for ali object modules contained on 
this file. 
EXECUTE_PRIVILEGE(CHAR 1) The tyne of execute to be attribute 
to be 
E associated with all object modules contained 


on this filee Vaitues for this fietd ares 
E =- executable - non voriviteged 
L - executable - tocal privilege 
G - executable - global oriviltege 
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DEFINE SEGMENT 


One DEFINE SEGMENT 


entry exists for each Preallocated Segment 


Descriptor. Either LOAD_ADDRESS or EXECUTE_ADDRESS and 


ATTRIBUTES must be 


DEF INE_SEGMENT, 


specified. 


LOAD_LADDRESS=(ring, seaqment, offset), a 


EXECUTE_ADDRESS=(ring,segment,offset)s, Ri=ring, Re=rings e-« 
R3=ring, GLOBAL_LOCAL_KEY=key, ATTRIBURES=Cattributes) +. e- 
SECTION_NAME=section_name 


FIELD 
DEFAULT 


LOAD_ADDRESS 
0 


EXECUTE_ADDRESS 


0 
R1 ii 
R2 it 
R3 i411 
GLOBAL_LOCAL_KEY 
0 
ATTRIBUTES 


SECTION_NAME 
blanks 


DESCRIPTION 


{IPL_PVA) Three component foad address (rings 
segment and byte offset) of the segment; 
specifies where the segment will be ltoaded. A 
null specification is indicated by a ring 
number of zero. 

{IPL_PVA) Three component execution address 
(rings, segment and byte offset) of the 
segment$ specifies where the segment will 
ultimatety execute. A null specification is 
indicated by a ring number of zero. If both 
LOAD_ADDRESS and EXECUTE_ADDRESS are not 
specified, offset loading will not de 
per formed. 

(INTEGER) Ring brackets for the segment. 


CINTEGER) Global and local key for segment. 


{CHAR 2?) Segment access attributes? any number 
of the following attributes can be specified. 
RD - read not controtied by key/tlock 

RK - read controtied by key/tiock 

BI - binding; read not controlled by 

key/tiock 

WT - write not controltted by key/iock 

WK - write controtied by key/iock 

EX = executable non privileged 

LP ~ executabte focal privilege 

GL - executable global vorivitege 

ET - extensible 

CB - cache bypass 
{CHAR 31) Name of Working_Storage sections to 
be mapped into this segment. 
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The OBJECT_MODULE command specifies module names to be included 
in the fink. Onty one OBJECT_MODULE command is allowed. 


OBJECT MODULE. NAME=(mod_name, mod_nameeee) 


FIELD DESCRIPTION 
NAME {CHAR 31) Name(s) of modules to be included. 
INBOARD SYMBOL TABLE 


The INBOARD_SYMBOL_TABLE command specifies NOS file names which 
contain Inboard Symboi Tables to be introduced into the LINK. 
Onty one INBOARD_SYMBOL_TABLE command is allowed. 
INBOARD_SYMBOL_TABLE, NAME=( filename, filename...) 
FIELD DESCRIPTION 


NAME {CHAR 7) NOS file name(s) of files containing 
Inboard Symbot Tabtes. 


END 


The END command or end-of-file signifies end of the Linker 
Parameter Fite. 
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320 LINKER FILE INTERFACE 


The Linker Parameter File interface, described in a preceding 
sections in its most specific sense prescribes the file interface 
of the Linker. The Linker File Descriptors (LFD*s) identify 
input object files and tibraries by name and their associated 
attributes. The Inboard Symbol! Table List CISTL) identifies by 
name inout filets) containing inboard symbol! tablets). 


NOTE Ail files named in the LFD and ISTL must be tocal at the 
time the Linker is invoked. 


The Linker Controt Biock {LCB), via the NAME_SEED, specifies the 
string used by the Linker to generate names for the outout files: 
header, segment, and outboard symbol table filese The Linker 
Program Descriptor ({LPD) and Segment Array specifically 
identifies the header and segment files by name. 


The following sections are a brief descriotion of the input 


files (object, fibrary and inboard symbol! table fites) and the 
outout files (Uhneader, segment, and outboard symbo! table fites). 
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3.1 OBJECT FILES 


The Linker acceptss as input, object files in containing 
object modules in CYBER 180 toader text format V1.1 generated oby 
compliers and assemblers running on CYBER 170. Muitinie object 
modules may reside on an object file. 


The object modufe structure is basically comprised of an 
Identification Record (IDR), Section Definition Records (SNC), 
and the object text associated with the sections. The IDR 
describes external characteristics (name, time and date created, 
version, creator, and a commentary) and internal characteristics 
{module attributes and the number of sections) of the object 
modute. There is a SOC fer each section tyce (code, bindina, 
working storage, common, etc.) contained in the object module 
describing the various attributes of the section. 


The specific structure of object moduies is not of general 
concern to users of the Linker, but for those who must generate 
object moduies {compiler,. assembler and utility writers), a covy 
of the object modute tyne definition may be found in Anpendix A 
of this document. 
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3-2 LIBRARY FILES 


The Linker also accepts as input Ci80 library fites containing 
ci80 object modules formatted into a library by the C180 Object 
Code Utilities. The definition of the object modules contained 
therein is the same as described in the section entittied *Object 
Flies”. 


The specific structure of a library file is not of general 
concern to users of the Linker, but for those who are interested, 
the record definition may be found in Apnpendix A of this 
document. 
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3.3 HEADER FILE 


Tne Linker outouts a header file which describes the results 
of a linkage.» The name of the header file is the concatentation 
of the NAME_SEED from the LCB with the string “HDR*. 


The header fite structure is comprised of one header variant 
and a segment descriptor variant for each segment file generated 
as the result of a tinkage. The header variant contains the 
number of segment descriptors, the initial p-address and its key, 
and the binding address. The seqment descriotor identifies by 
name the file on which the segment was written and its segment 
attributes. 


Tne specific structure of the header file is not of general 
concern to the users of the Linker, but for those who must 
interface to the header file a copy of the tyce definition can be 
obtained by contacting an SES representative. 
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3.4 SEGMENT FILES 


The Linker outputs segment files which are acceptable as input 
to the CYBER 180 Simutator or VE Generator. A segment file 
contains a direct 1/0 user information record. In the context of 
the Simutator the segment fite is a toad file and the user 
information record is a Load File Directory of type “*emoty*. The 
Linker allocates and outputs a segment file for each section type 
encountered on object fiies during a iinkage. 


The segment file structure is comprised basically of a load 
file directory and the tinked segment. 


The specific structure of the segment file is not of general 
concern to the users of the Linker. A description of the files 
however, may be found in fhe €180 Simulator ERS» in the appendix 
section entitied "Central Memory Format’. 
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(325 SYMBOL TABLE FILES 


A symbol table file is a file containing a tabite of resolved 
entry points from an instance of Linker execution. The file is 
termed an Inboard Symbo! Table file when used as input to the 
Linker. The fite is termed an Outboard Symbol Tabie file when it 
is outpuf as a result of Linker execution. 


The Outboard Symbot Tabie (0ST) file is aenerated by the 
Linker only if entry points which nave the “gated” attribute are 
encountered during a Linker execution. {Only entry points with 
the “gated” attribute are externalized to modules in higher 
rings. This attribute is specificality assigned to a module via 
the Object Code Utility CHANGE command.) The OST file name is 
the concatentation of the NAME_SEED from the LCB with the string 
*OsT*. 


The structure of ae$symboi tabie is pertinent onty to the 
Linker. 
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4&e0 LINKER MAP 


The Linker map describes the address assignments made by the 
Linker. The NOS file name, onto which the Linker mac is output, 
is specified either as a VELINK command parameter, or else in the 
Linker Parameter Fite. The Linker map contains four basic 
components which may be optionatiy listed. A sampte map is 
inctuded in a tater secticn. 


4e1 SECTION DEFINITIONS 


The folttowing information is orinted for every section of 
every object module: 
: Section type 
Access attributes 
Length 
Address (load and execution if different) 
Ring brackets 
Giobai/iocail key 


ooo000 


Ge2 ENTRY POINT NAMES 
a 
Tne following informaton is printed for every entry point: 


Oo name 
o address (toad and execution if different) 


403 EXTERNAL REFERENCES 


A tist of the external references is vrinted after the entry 
point tist. 
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4e% QUTPUT SEGMENTS AND COMMON BLOCKS 


The following information is printed for every output segment 
allocated by the Linker? 


NOS fite name 

Address {load and execution if different) 
Length 

Access attributes 

Ring brackets 

Giobat/iocal key 


eoooo0o 0 


The following information is printed for every common biock 
allocated by the Linker? 


o Name 

o Access attributes 

o Length 

o Address (load and execution if different) 
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5e0 LINKER PROCEDURAL INTERFACES 


The foltowing sections are aiso contained in the SES User's 
Handbook. 


| GENCPF = _ GENERATE A_ CHECKPOINT FILE (CPF) 


GENCPF executes the SES VE Linker and the SES VE Generator and 
produces a Checkpoint File (CPF) which can be toaded and executed 
on the CYBER 180 system simulator. The user must provide a file 
containing 180 object text, and can optionally provide a Linker 
Parameter File (LPF). a set of Monitor Segment files+s and/or a VE 
Generator ODIRective file. The "MF" file will contain the map 
eroduced by the VE Linker and additional information produced by 
the VE Generator. 


Notes most of the following parameters Will not be used by the 
*general public* examples show general usage). 


Parameters to GENCPF are? 


ofi (Filename(s), optiona!) 
Object_Filte_List - tist of up to 10 names of files 
containing 180 object text {ver 1.0). This parameter 
does not have a default. 


ifi (Fitename{s), optional) 
Library_Fite_List - list of up to 10 names of Library 
files containing 180 object text. This parameter does 
not have a default. 


pep (String(31), optional) 
Primary_Entry_Pcint - This oarameter specifies the 
entry point at which to start execution. The default 
is to start execution at the first Transfer symbol 
encountered. 


ns (String(4), optional) 
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Name_Seed - This parameter specifies the “name seed" 
for the VE Linker Segment files. The default for this 
parameter is “SEGM*. The value of this parameter 
OVERRIDES any Linker Parameter Fite specification of 
this fietd. 


mf (Filename, optionsi) 
Mao_Filte ~ This parameter soecifies the name of the map 
file. The default for this parameter is *LINKMAP*. 


mo (Char 1, optionai) 
Linker Map options - This parameter specifies the 
amount of information output on the Linker Map. The 
value of this parameter OVERRIDES any Linker Parameter 
File specification of this fietd. Values for this 
fieid are: 
N - no map informations; diagnostics are output. 
3 - section altocations for every section of every 
inout object modute 
E - Section alfocations plus entry point names and 
address assianments 
M = Section ailocationss entry coints plus output 
segment and common bitock allocations (full 
Linker map). 


rewind (Keyword, optional) 

Rewind _map_filte - This parameter specified whether to 
rewind the Mac file before it is written. Default is 
to rewind ite The value of this rvcarameter CVERRIDES 
any Linker Parameter File specification of this field. 
Keyword value meanings ares 

REWIND - rewind Map fite 

NOREW - don"t rewind Map file 


cof (Fitename, optional) 
Checkpoint_File - This parameter specifies the rame of 
the file containing the output from the VE Generator. 
The default is “°CPFILE*. The vaiue of this parameter 
OVERRIDES any Linker Parameter File specification of 
this field. 


iof (Filename, optional) 
Linker_Parameter_File - This parameter specifies a file 
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that contains Linker parameters frat affect the Link. 
If no tpf is specified, default values indicated in the 
LPF description apply. 


cybilib (Keyword, optional!) 
This parameter, when specifieds wiii cause CYBILIB to 
be used to satisfy externais during the linking 
processe The procedure will ACQUIRE the file from SES 
and add it to the Library_Fite_List. The defauit is 
not to use CYBILIB as vart of the Link. 


dir or tdrdir or d (Ffitename, optional) 
Directives - This parameter specifies the name of a 
fite containing directives to the VE Generator. The 
default will be a file containing default directives. 


mtrns or mns (Stringt4), optional) 
Monitor Name_Seed - This parameter snecifies the ‘name 
seed* of the VE Linker Segment files that contain the 
Monitor code. This parameter is provided to attow the 
user to have his own Monitor program. The default for 
this parameter is “MTRX*. The procedure will check the 
local files, the focal PF cataiog, and then the SES 
cataiog to get the files. 


Exampies? 


The following example illustrates now a user would compile a test 
program written in CYBIt», generate a Checkpoint Files and run it 
on the Simulator. 


sesecybil ci i=testorg t=testist b=testigo 
sesegencof ofi=testigqo cpof=testcpof cybilib 
ses.simi80 restart=testcof 

?) run 

? 8 6pye 


The last two fines were Simutator commands. 

The next example iftlustrates thow to generate a Checpoint File 
from several input files of 180 object text. . 
sesegencof oft={my!lgolsmyigo2) cof=mycpof cybilib 
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VELINK - EXECUTE THE VIRTUAL ENVIRONMENT LINKER 


VELINK executes the VE Linker, which links data from 180 object 
files/iibraries and produces a map file anda set of SEGMent 


own Linker Parameter File containing VE Linker variabies 
that contro! the tinkage. For" Wore information on this, refer fo 
the SES VE Linker ERS (ARH2816). 


filese The procedure is set ‘a ry that the user can specify his 


Note: This proc is generally used only in special cases, where 
GENCPF is inadequate. 


Parameters to VELINK ares 


of! (Filename(s), optional) 
Object_File_List - list of up to 10 names of files 
containing 180 object text (yer 1.8). This parameter 
does not have a default. 


if! (Filename(s), optional) 
Library_Filte_List - list of up to 19 names of Library 
files containing 130 object text. This parameter does 
not have a default. 


pep (String(31), optional) 
Primary_Entry_Point - This parameter specifies the 
entry point at which to start execution. The default 
is to start execution at the first Transfer symboi 
encountered. 


ns (String(4), optional) 
Name_Seed - This parameter specifies the ‘name seed* 
for the VE Linker Segment files. The default for this 
parameter is “SEGM*. The vatue of this parameter 
OVERRIDES any Linker Parameter File specification of 
this field. 


mf (Filename, optional) 
Map_File - This parameter specifies the name of the mano 
file. The default for this parameter is *LINKMAP®. 
The vaiue of this parameter OVERRIDES any Linker 
Parameter File specification of this field. 
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mo (Char 1, optional) 


Linker Map options - This parameter specifies the 
amount of information outout on the Linker Map. The 
value of this scarameter OVERRIDES any Linker Parameter 
File specification of this field. Values for this 
field ares’ 
N=- no map information’ diagnostics are output. 
$ ~ section aliocations for every section of every 
input object modute 
E - Section atlocations pius entry point names and 
address assignments 
M- Section allocations, entry soints plus output 
segment and common block allocations (full 
Linker map). 


rewind (Keyword, opt ional)> 


Rewind _map_fite - This parameter specified whether to 
rewind the Mar file before it is written. Default is 
to rewind ite The vaiue of this parameter CVERRIDES 
any Linker Parameter File specification of this field. 
Keyword value meanings are? 

REWIND ~- rewind Map file 

NOREW - don*t rewind Map fite 


tof (Filename, optional) 


cybilib 


Example: 


Linker_Parameter_Fite - This parameter specifies a file 
that contains Linker parameters that affect the Link. 
If no tof is specified, default vatues indicated in the 
LPF description apply. 


{Keywords optional!) 

This parameter, when specified, wilt cause CYBILIB to 
be used to satisfy externals during the linking 
process. The crocedure will ACQUIRE the file from SES 
and add it to the Library_File_List. The default is 
not to use PASILIB as part of the Link. 


In the fottowing examole the Linker is passed a Linker Parameter 
File containing the variabie °mylicb*. 


ses.velink of i=(igoil,igo2) itpf=myiopf icbh=myichb vef=myvef 
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Sei EXAMPLE OF LINKER. PARAMETER FILE 


The following is an exampite of a Linker Parameter File. Since 
the Linker ignores items in the tist with blank or uninitiatized 
file names», this attlows you to include the deciaration and access 
attribute initiatization of the object fite list in your command 
file,y leaving onty the specification of inout file name until you 
are ready to issue the LINK command. 


tink _options»sman_filename=linklist,map_opt ions=msno_man_rewinds 
name _seed=Ixxx,load_ segment=6,execute _seaqment=6 


object fileskfn="* *sri=1Li,r2=11,r3=11,giobai_tocal_key=0, 
execute _privilege-e 


object_fileskfn=" “sri=11,.r2=1isrs=i1egiobal_tocal_key=0, 
execute_orivilege=e 


object_file,kfn=* *,r1=11.r2=11,r3=11,gliobal_local_key=0, 
execute_privilege-e 


object_file,kfn="* “*.sri=11,r2-1i,r3=1isgiobal_tocal_key=0, 
execute_privitege-e 


define_segment,load_address=(11,0,4000) ,execute_address=(11,0,5 
4000) sri=11.r2=11.r3=11,global_tocal_key=0,attributes=(rd,ex) 


define_segment,toad_address=(11,0,5000) sexecute_address=(11,0; 
5000) ,ri=1i.sr2=11.r3=-11, gtobat_tocal_key=0,attributes=(bi) 


define _segment,lioad_address=(11,0,6000) ,execute_address=( (11.0, 
6000) ,ri=11,r2=11,r3=11,g9lobal_locai_key=D,attributes=(rdawt) 


define segment, load_address=(11,0,7000) ,execute_address=( (1190, 
7000) sri=11,sr2=11,r3=11,9lobal_tocal_key=0,attributes=(rd wt,et) 


define _segment,ioad_address=(11,0,8000) »,execute_address=(11,0, 
8000) sri=11i»sr2=11,r3=11,gliobai_tocal_key=0,attributes=(rd) 
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5e2 EXAMPLE OF LINKER MAP 


The following tinkmar wa 


S$ produced by 


linking the sample 


program described in the ERS for the 180 CPU Assembler. 


LINKER V 2.25 OUTPUT 
MODULE = TEST 
FILE = LGO 95/21/79 


SECTION TYPE/ 
ACCESS ATTRIBUTES LENGTH 


WORKING STORAGE 
READ WRITE 28 


WORKING STORAGE 


READ 8 
BINDING 

READ BINDING 10 
CODE 

READ EXECUTE 22 


ENTRY POINT DEFINITIONS 
ENT 
LINKER V 2.25 OUTPUT 


SES/C80 LINKER OUTPUT = LCB 
PCB 
LPD 


towou 


PRIMARY ENTRY POINT 
ADDRESS 


Hou 


FILE NAME/ 


LISTING 05/21/79 


LANGUAGE = CPU ASSEMBLER 
163200206.000 


LOAD/ 
EXECUTION ADDR 


AERA MRCS RRS RE AERIS AEROS ARC SAE ener CREED SIR AS I ETN Aan eos AE CEA HY EEN AR UrbOR mci ARGOS AORN AbD ES CE Atm theta ane valniR amspaee 


B 000 909000000 


B O0C 00000600 


B 008 00000000 


B BO0A 00000000 


RING 
BRACKETS G/L KEY 


(B,B,B) (00,00) 


(B,B,8) (00,00) 


(B,B,8) (00,00) 


(B,8,8) (00,00) 


ADDRESS 
NOT GATED 8B BOA 00000000 
LISTING 05/21/79 16.00.46 


LINK _CONTROL_BLK 
LINK_PCB 
LINKED_PRG_DESC 


ENT1 
B O0A 00000000 


LOAD/ 


RING 
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ACDESS ATTRIBUTES LENGTH EXECUTION ADDR BRACKETS G/t KEY 
SEGMi0i2.2......° °°” © OR tere tye ene Sere et es 
READ EXECUTE 22 * H0A 00000008 (B,B,B) (00,00) 
SEGM102 
BINDING 10 * 008 09000000 (8,8,8) (00,00) 
SEGMi03 
READ 8 * 90C 00000000 {B,8,8) {680,00) 
SEGM1LO%& 
READ WRITE 28 * 900 900008080 {B,B,B) (00,00) 


NO LINKER ERRORS WERE DETECTED 
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6-0 ERROR MESSAGES 


Tne Linker provides two varieties of error message? SES SCL 


error 


messages describing the disposition of the command, and 


linker diagnostics printed on the Linker map. 


6e1 SCL MESSAGES 


Linker SCL messages conform to the SES message standards as 
described in the Meggage Generator (MG) Interface ERS. 


10008 


10100 


10101 


10102 


LINKER NORMAL TERMINATED 
MEANING? The Linker has terminated normatily with 
no fatai or nonfatal errors. 
ACTION: 8e thankful. 


LINKER NORMAL TERMINATE WITH NONFATAL ERRORS ~ SEE MAP 
LISTING . 
MEANING? One or more non fatal errors were 
encountered during the Linker Command. 
Linker outout is probably vaiid. 
ACTION? Check Linker map for diagnostic or 
diagnostics. 


LINKER ABNORMAL TERMINATE - SEE MAP LISTING 
MEANING? The Linker has detected a fatal error and 
gracefully aborted. Linker output is 
undefined. 
ACTIONS Check Linker map for diagnostic! correct 
probtem and rerun 


LINKER ABNORMAL TERMINATE - NO MODULES PROVIDED 

MEANING? No object module input was encountered by 
the Linker. 

ACTION: Check the ‘ofi*® parameter on the LINK 
command, if specified, or elise the 
OBJECT_FILE in the Linker Parameter File}; 
check the KFN fields of all elements of 
the object fite fist $ check all files for 
input. 


COMPANY PRIVATE 


‘elo ha 


oo 


oe 


oo dee me 


6-2 


COC ~ SOFTWARE ENGINEERING SERVICES 


027157380 


ERS for SES Virtual Environment LINKER REV: G 
6.20 ERROR MESSAGES 
621 SCL MESSAGES 


10200 


10201 


18202 


10203 


10204 


10300 


LIBRARY FILE fite_ name NOT LOCAL 
MEANING? Fite specified by the "1fi*parameter of 
the VELINK command or the 
*OBJECT_LIBRARY* command of the Linker 
Parameter File is not a tocal file. 
ACTIONS Make the _ fite local or remove the 
parameter. 


OBJECT FILE file_name NOT LOCAL 
MEANING? File specified by the “ofl*parameter of 
the VELINK command or the ‘“GBJECT_FILE* 
command of the Linker Parameter File is 
not a focal file. 
ACTION: Make the fiie local or remove the 
parameter . 


OBJECT FILENAME file _name DUPLICATES EXISTING FILE 
MEANINGS Filename specified as and object file or 
library C*ofi* or “*ft* of the VELINK 


command | or “OBJECT_FILE* or 
*"OBJECT_LIBRARY* of the Linker Parameter 
File duplicates another specifed 


filename. 

ACTIONS Remove the snecification of this file. 
Make The fite tocal or remove the 
parameter. 


IST FILE file _name NOT LOCAL 


MEANINGS Fite specified by the 
*“INBOARD_SYMBOL_TABLE “command of the 
Linker Parameter File is not a toca! 
file. 

ACTIONS Make the file local or remove the 
parameter. 


IST FILENAME file name DUPLICATES EXISTING FILE 

MEANINGS Filename specified by the 
*INBOARD_SYMBOL_TABLE®* command of the 
Linker Parameter File duplicates another 
specifed filename. 

ACTIONS Remove the specification of this file. 
Make the fite tocai or remove the 
parameter. 


LPF FILE file _name NOT LOCAL 
MEANINGS Fite specified by the ‘*lof* parameter of 
the VELINK command is not a tocal file. 
ACTIONS Make the fite local or remove the 
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10301 


10302 


109303 


10304 


10305 


parameter. 


UNKNOWN LPF COMMAND command SPECIFIED 
MEANING? The Linker has detected an invalid Linker 
Parameter File command. 
ACTION? Correct the Linker parameter fiie. 


INVALAD MAP OPTICN map_option SPECIFIED 
MEANING: The Linker has detected an invalid mao 
option specified by the *mo"* parameter of 
the VELINK command or "MAP _CPTIONS* 
specification of the Linker Parameter 
File *LINK_OPTIONS* command. 
ACTION: Correct the mao option specification. 


INVALAD NAME_SEED xxxx SPECIFIED 
MEANING: The Linker has detected an invalid name 
seed as specified by the ‘ns* parameter 
of the VELINK command or ‘NAME _SEED* 
specification of the Linker Parameter 
Fite “LINK _OPTIONS* command. 
-ACTION: Correct the name seed specification. 


INVALAD SEGMENT ATTRIBUTE segment_attribute SPECIFIED 
MEANING? The Linker has detected an invalid 
segment attribute specified by the 
*ATTRIBUTES* specification of the Linker 
Parameter File "“DEFINE_SEGMENT* command. 
ACTIONS Correct the attribute specification. 


INVALAD EXECUTE PRIVILEGE executive_orivilege SPECIFIED 

MEANINGS The Linker has detected an invalid 
executive privitege specified by the 
"EXECUTIVE _PRIVILEGE" specification of 
the Linker Parameter File *OBJECT_FILE* 
or “OBJECT_LIBRARY* command. 

ACTION: Correct the executive privilege 
sceci fication. 
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602 LINKER DIAGNOSTICS 


The Linker orints formatted messages on the Linker map. The 
temptate of ail messages is as follows: 


* * * LINKER ERROR NNNNN C*FATAL*] <error message text> 


MODULE = <module name if approoriate> 
FILE = <file name if appropriate> 
NAME = «entry point name if appropriate> 


RECORD COUNT <record count if appropriate> 


NNNNN ERROR MESSAGE TEXT 


1 IMPROPER RELOCATION ADDRESS SPECIFICATION 
MEANINGS RIF item is being inccrrectiy oaenerateds$ 
Linker output unaffected. 
ACTIONS Correct object text. 


2 UNANTICIPATED EOR 
MEANINGS The Linker encountered an EOR somewhere 
other than the appropriate end of an 
object module 
ACTION: Correct object text 


3 MORE THAN ONE CODE SECTION IN A MODULE 
MEANINGS A singte object module had more than one 
code section; only one is permitted. 
ACTION: Correct object text. ; 


by SDO GREATER THAN IDR SPECIFICATON ENCOUNTERED 
MEANINGS fhe number of sections in the IDR is 
incorrect or section oordinais do not 
start at zero or are not contiguous. 
ACTION: Correct object text. 


5 CODE SECTION ATTRIBUTE SPECIFICATION ERROR 
MEANINGS Code sections must not have write or 
binding attributes. 
ACTION? Correct object text. 


6 MORE THAN GNE BINDING SECTION PER MODULE 
MEANING? A single object module had more than one 
binding sections onty one is permitted. 
ACTIONS Correct object texte 


7 BINDING SECTION ATTRIBUTE SPECIFICATION ERROR 
MEANINGS Binding sections must not be writabie or 
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executable. 
ACTION? Correct object text. 


8 BINDING SECTION ALIGNMENT ERROR 
MEANINGS The binding section must be aligned on a 
64 bit CYBER 180 full word boundary. 
ACTIONS Correct object text. 


3 DUPLICATE SECTIGN DEFINITION ORDINAL 
MEANINGS The same ordinal has been used for two 
sections in a single cbject module. 
ACTION Correct object text. 


10 BINDING ATTRIBUTE SPECIFIED FOR A NON BINDING SECTION 
MEANING$ The binding attribute may onty oe 
specified for the binding section. 
ACTION? Correct object text. 


it CONFLICTING PROTECTION ATTRIBUTE FOR COMMON BLOCK 
MEANING? Oifferent protection has been specified 
in separate common bicck dectarations. 
ACTIONS Correct source program. 


12 CONFLICTING LENGTH SPECIFICATION FOR COMMON BLOCK 
MEANINGS Unequal tengths were specified in 
separate common block dectiarations. 
ACTIONS Correct source orogram. 


13 COMMON TABLE OVERFLOW - RECOMPILE LINKER 
MEANINGS tCLinker internat tabte size exceeded. 
ACTION? Cat! SES representative. 


14 MISPLACED IDR OR SDC 
MEANINGS: Chject text structure is incorrect. 
ACTION? Correct object text. 


15 MODULE DID NOT CONTAIN A CODE SECTION 
MEANING? No code section encountered; Linker 
output unaffected. 
ACTIONS Correct object text if necessary. 


16 MODULE DID NOT CONTAIN A BINDING SECTION 
MEANING? No binding section encountered$} Linker 
output unaffected. 
ACTION: Correct object text if necessary. 


17 SDOS NOT CONTIGUOQUSLY NUMBERED 
MEANINGS Object text structure is incorrect. 
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18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


ACTIONS Correct object text. 


SEGMENT TABLE OVERFLOW - RECOMPILE LINKER 
MEANING? Linker internal tabie size exceeded, 
ACTION: Call SES representative. 


ZEROIZE SECTION INTERNAL LOGIC ERROR 
MEANING: Linker has aborted. 
ACTIONS Cait SES representative. 


PROCEDURE DESCRIPTOR ALLOCATED IN NON BINDING SEGMENT 
MEANINGS Procedure descriptors that are to be used 
with the tnardware CALL instructions must 
be in binding segments. 
ACTION? Correct object text if necessary. 


POINTER IN BINDING SEGMENT WAS MISALIGNED 
MEANING3 Binding section entries must be right 
justified in an CYBER 180 full word. 
ACTION: Correct object text. 


ATTEMPTED TO PLACE DATA IN A BINDING SECTION 
MEANINGS Binding section entries may oniy be 
peinters or procedure descriptorse 
ACTIONS Correct object text. 


LFD RING BRACKET SPECIFICATION ERROR 
MEANING? An Litegal ring number was encountered or 
Ri>R2>R3. 
ACTIONS Correct LFD entry and retry LINK command. 


PREALLOCATED BINDING SEGMENT ATTRIBUTE ERROR 
MEANING3 Binding segments may not be writabie or 
executable or readable under key tock 
control. 
ACTION: Correct PSA entry and retry LINK command. 


PREALLOCATED EXECUTABLE SEGMENT ATTRIBUTE ERROR 
MEANINGS Executable segments may not be writable. 
ACTION? Correct PSA entry and retry LINK command. 


PREALLGCATED SEGMENT RING BRACKET INCONSISTENCY 
MEANING? The retationship R1I<R2<R3 did not apply. 
ACTION? Correct RSA entry and retry LINK command. 


PREALLOCATED SEGMENT ADDRESS (RING) ERROR 
MEANINGS An Lfttegal ring number was specified. 
ACTIONS Correct PSA entry and retry LINK command. 
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29 


36 


31 


32 


33 


34% 


35 


FIRST RECORD OF AN OBJECT MODULE WASNT AN IDR 
MEANINGS Improper object text structure or Linker 
input file was inappropriate. 
ACTION? Correct input file. 


DUPLICATE ENTRY POINT WAS DETECTED 
MEANINGS A symbol has been xXDCLed as an entry 
point more than oncee First definition 
is used$ outout is unaffected. 
ACTIONS Correct object file tist if necessary. 


LST OVERFLOW - TOGO MANY ENTRY POINTS 
MEANINGS Internal table overfionw - Linker must be 
recompiled. 
ACTIONS Cati SES representative. 


EXTERNAL ARRAY CVERFLOW - TOO MANY EXTERNALS 
MEANING? Internai Tabte overfiow - Linker must be 
recompiled. (Maximum is 280 entries.) 
ACTION? Cait SES representative. 


RECORD CONTAINS IMPROPER S$DO 
MEANINGS An object text record referenced an 
undefined object text section. 
ACTIONS Correct object text. 


INPUT RECORD CONTAINS AN IMPROPER SECTION OFFSET 
MEANINGS An object text record referenced an 
offset outside fhe range specified in the 
section definition. 
ACTIONS Correct object text. 


NO PRIMARY ENTRY POINT ENCOUNTERED 
MEANINGS No primary entry point was specified. 
ACTION: Dectare a procedure in your PASCAL-X 
program with the ‘“*MAIN* attribute or 
piace the primary entry point name in the 
PEP field of the PCB. 


PRIMARY ENTRY POINT NOT XDCLED 
MEANINGS The name encountered by =the Linker for 
the primary entry point was not xXDCLed in 
any object module encountered in the 
iinkage. 
ACTIONS ODectare a procedure in your ISWL program 
with the *XDCL” attribute. 
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36 


37 


38 


39 


4&0 


44 


42 


K3 


NO OBJECT FILE INPUT 

MEANINGS No object module input was encountered by 
the Linker. 

ACTIONS Check the OBJ_FILE_LIST parameter on the 
LINK command if specified, or else the 
PCB.OBJ_FILE_LIST_NAME for an LLNS name$3 
check the KFN fields of all efiements of 
the object file tist3 check ali elements 
of the object file tist$3 check all files 
for input. 


UNSATISFIED EXTERNAL REFERENCE 

MEANINGS An XREFed dectaration was not xXDCLed in 
any moduie encounterd in the linkage, or 
on any of the moduies on the specified 
{fibraries. 

ACTIONS Check input file tist to assure that you 
specified all the files you intended to$ 
check your orogram for a missing *XDCL*. 


LFD CONTAINS IMPROPER EXECUTE ATTRIBUTE 
MEANING? Unknown execute attribute was snecified 
in LFD. 
ACTIGN: Correct LFD and retry LINK command. 


UNKNOWN OBJECT TEXT RECORD TYPE 
MEANINGS Object text structure is incorrect. 
ACTIONS Correct object text. 


UNKNOWN EXTERNAL REFERENCE INSERTION TYPE 
MEANINGS Object text structure is correct. 
ACTION: Correct object text. 


UNKNOWN SECTION DEFINITION TYPE 
MEANING: Object text structure is correct. 
ACTION: Correct object text. 


RIF DOES NOT PERTAIN TO CODE OR BINDING SECTION 
MEANING? Relocation information is being 
incorrectiy generated. Linker output is 
unaffected. 
ACTIONS Correct object text. 


IMPROPER RELOCATION CONTAINER SPECIFICATION 
MEANINGS Relocation information is being 
incorrectiy generated. Linker output is 
unaffected. 
ACTION: Correct object text. 
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44 


&5 


46 


4&7 


4&8 


49 


EXPECTED SCO RECCRD 


MEANINGS Object text structure is incorrect. 
ACTION: Correct object text. 


INVALID PROCEDURE OFFSET FOR INDIRECT CALL 

MEANINGS The procedure offset for an indirect cali 
is not 0 mod 38.2 To facilitate “binding”, 
procedure offsets for indirect catts 
shoutd be 0 mod &. 

ACTION? None necessary at this time, but the 
object text generator should be modified 
to allocate ail procedures on a word 
boundary. 


INVALID BIT STRING INSERTION RECORD 

MEANINGS The Linker encountered a bit string 
insertion record with a bit offset 
greater than 7 or bit tength greater than 
S7. No bit string insertion has taken 
place. 

ACTION: The object text generator has caused the 
error and must be corrected. 


BAD LIBRARY FORMAT 
MEANINGS A fite in the Library File List was not a 
recognizabie 180 Library created by the 
SES CYBER 180 Object Code Utitities. 
ACTION? Review the Libraries specified in the 
*Library File List‘. 


REQUIRED LIBRARY MISSING 
MEANINGS The Linker encountered a Libraries record 
that specified a library that was not 
present in the ‘Library File List*. 
ACTIONS ACQUIRE the tibrary and specify it in the 
“Library File List". 


ERROR IN PARAMETER VERIFICATION 
MEANINGS The type dectarations for the variabie do 
not match on the XDCL and the XREF. 
ACTIONS Check the type deciarations for the 
variable, they must be word for word. 
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A1.0 SES/C180 OBJECT TEXT FORMAT 


For th 


For a 
arranged 


< object text descriptor 
< object text record # 
< object text descriptor 


< 


< object text descriptor # 


The general form of an object module is a file of binary records 
with the following topology? 


NO fe eH te 
vN v 
v 


object text record # 


> 
Vv 


<object text record #n > 


e sake of simplicity the record descriptor - record pairs 


1). 
2e) 


3)-« 


PPU 
in 


wilt’ be referred to as records hereafter. 


For a CPU program, the object text records must be arranged in 
the following order: 


Identification record 

Library, section definition, text, bit string insertion, 
address formulation, externat tinkage, entry definition, 
relocation, formal parameter specification, actual! 
parameter specification and binding template records in 
arbitrary order with the one stipulation that a section 
definition record must precede any otter object text 
records that refer to the section. 

Transfer symbo!f record. 


oroagram or overlay, the object text records must be 
the following order: 
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1.) Identification record 
2e) PPU absolute record 


aA A me 


{ Constants that pertain to beth the object and toad modufe. } 


CONST 
ficgmax_adr_items 
iicSmax_ext_items 
lictmax_tibraries Offf*f (16), 
licSmax_rel_items Offff{16), 
fictmax_section_ordinat = Of fff{16) = 13 


Offff (16), 
OFfff(16), 


fou wou 


TYPE 
litsobject_text_descriotor = record 
case kind: fitobject_record_kind of 
= lic$identifications lic8section_definition, lictbit_ustring_insertion, 
lic$entry_definitionse tictbinding_temoliate, licstransfer_symbol], 
oct$iibrary_neader = 
unused: ost$seaqment_offset, {must be zero} 
= ticS$libraries = 
number_of_tibraries? 1 .e. l!ic$max_libraries, 
= ficStext, ticgreptication = 
number_of_bytes? 1 .«- osctmax_segment_iength; 
= tic$retocation = 
number_of_reit_items’ 41 eo. tic$max_rei_items, 
= Yictaddress_formutation = 
number_of_adr_items:? 1 e. tictmax_adr_items, 
= lictexternal_ltinkage = 
number_of_ext_items! 1 .e. Iictmax_ext_items, 
fictformal_parameters, ticgactual_parameters = 
Ssequence_ltength? ost$segment_ltength, CREP sequence_length OF CELL} 
= lic$ppu_absolute = 
number_of_words: tit$opu_address, 
= oct$module directory, oct$entry_point_directory = 
number_of_directory_entries:? integer, 
casend, 
recend: 


tt 


TYPE 
1tittopject_record_ kind = (lictidentification, iic$libraries, 
tic$section_definition, lticttext, lictreplication, 
fictbit ustring_insertion, ftictentry_definitions, ticfretocation, 
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ficsaddress_formulfations tictexternal_linkage, ticgformal_ parameters, 
iicsactual_parameters, tictbinding_template, tictopu_absolute, 
fic$reserved_1, !ic$reserved.2, lictreserved_3, licf$reserved_4, 
ficttransfer_ symbol, oct$tibrary_header, oct$module_directory, 
octtentry_point directory) $ 


TYPE 

{itsidentification = record 
name? omttprogram_names 
object_text_version? string (4), € *Vi.i* } 
kinds ilit$modute_kind, 
time_created: ost$time, 
date_created? ost$date, 
attributes? litSmodule_attributes, 
greatest_section_ordinat: lit%’section_ordinal, 
generator_id? litgmodule_generator, 
generator_name_vers? strinsc (40), 
commentary: string (40), 

recend, 


1itegmodule_kind = (fic$mi_virtuai_state, tict$vector_virtual_ state, 
ficBiou)$ 


TYPE 
1itgmodule_generator = (fic$algol., lictanl.,. lickbasics, fictcobol, 
fictassembier, tic$fortran, ticfobject_iibrary_generator, 
fictpascal,s ficfceybil, tictpl_i,s tic$sympli), 


fitsgmodule_attributes = set of (fictnonbindable, Lic$nonexecutable) 3 


TYPE 
1itgtibraries = array { * J] of amttiocal_filte name; 


TYPE ;, 

iitgsection_definition = record 
kind? iitt$section_kind,s 
access_attributess tit$section_access_attributes, 
section_ordinat: iitésecticn_ordinal, 
length? ost$segment_tength, 
allocation_atignment:? ost$segment_offset, 
allocation_offset: ost$segment_offset, 
name? omtSprogram_name, 

recends 
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titssection_ordinal = 0 «. ticg$max_section_ordinai, 
1itsection_offset = 0 .. osc tmaximum_offset; 


TYPE 
1itssection_kind = (fitctcode_section, iic$bindina_ section, 
iitc$working_storage_sections tictcommon_bliock, 
iicf$extensible_working_storage, lticfextensibie common_block, 
licSinvalid_section) , 


fitesection_access_attributes = set of (licfread, ficEwrite, lickexecute, 
fic$binding) $ 


{ Text record. } 


TYPE 
1itsStext = record 
section_ordinais: iitSsection_ordinal, 
offset: itt$section_offset, 
byte? array [ * 1] of 0 «2 255, 
recend$ 


{ Replication record. } 


TYPE 

1itgreoltication = record 
section_ordinai: iitt%secticn_ordinal, 
offset? titSsection_offset, 
increment? 1 2.2 osc$max_seament_tength, 
count? 1 es osc$max_segment_iengths 
bytes array { * ] of 0 ee 255, 

recend$ 


{ Bit insertion record. } 


TYPE 
1it¢bit string _insertion = record 
section_ordinai: iitSsection_ordinalt, 
offset? iitsSsection_offset, 
bit_offset: 0 «2 7s 
bit_length: 41 ee 63% 
bit_string? packed array [1 .«. 63] of 0 e. ls 
recend; 


{ Address formutation record. } 
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TYPE 
iitgaddress_formulation = record 
value _section: fit¢section_ordinal, 
dest section? ttt$section_ordinal, 
item: array [€ * ] of ilttaddress_formulation_item, 
recend, 


fitgaddress_formulation_item = record 
kind: i1tfinternal_address_kind, 
value_offset: titgsection_offset, 
dest_offset: tit¢section_offset, 
recend, 


iifttaddress_kind = (tlcfova,. tictinternai_proc, tictone_word_externati_oroc 
itctexternal_proc, !ic$address_addition, tictaddress_subtraction) , 


littinternal_address_kind = itcf$ova «e Lic$external_proc$ 


{ External reference record. } 


TYPE 

fittexternal_tinkage = record 
names omtSprogram_name, 
fanguage: lit$S$module_generstor, 
dectaration_matching required? boolean, 
deciaration_matching_value? integer, 
item: array [€ * ] of titsexternai_linkage_item, 

recends 


1itgsgexternal_tinkage_item = record 
section_ordinali:?: iittsection_ordinatl, 
offset: littsection_offset, 
kinds: titSaddress_kind, 
offset_onperand’ osttsegment_offset, 
recend$ 


{€ Entry point definition record. } 


TYPE 
titsgentry_definition = record 
section_ordinal? tit$section_ordinal, 
offset: tittsection_offset, 
attributes? iilttentry_point_attributfes, 
names pomtSprogram_names 
language’ fitSmodute_generstor, 
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deciaration_matching_reaquired: boolean, 
declaration_matching_vatiue?: integer, 
recend, 


iit¢entry_point_attributes = set of (lictretain_entry_point , 
lic$gated_entry_point) $ 


TYPE 
fit¢retlocation = array { * 3 of litreiocation_item, 


1itgrelocation_item = record 
section_ordinal: litS$section_ordinai, 
offset: itttsection_offset, 
relocating _section: iittsection_ordinatl, 
containers titsSretocation_container, 
address’ iittaddress_ type, 
recends 


litgrelocation_container = (lic$parcel, lickthnree_bytess licthatfword, 
ttc$word, ilictd_fieid, tictq fields lic$long_d_ fietdd, 


{itgaddress_type = (licSbyte_positive, iicfoarcel_positive, 
licShaifword_pvositive, lictword_positive, tictbyte_signed, 
lictearcel_ signed, ticthatfword_ signed, ftic$word_signed) 3 


{ Procedure formal parameter description record. } 


TYPE 
iittformal_ parameters = record 
procedure_names pmt$program_name, 
specification: SEQ {( *¥ ), 
recend$ 


{ Procedure calt actual parameters record. } 


TYPE 
litfactusal_parameters = record 
calliee name? omtfprogram_namey 
language: tit$modulte_generstor, 
fine_number_of_cati: iit#source_tine number, 
specification: SEQ ¢( * ), 
recend,s 


jitgsource_line_number = string (18)35 
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{ FORTRAN argument description: used to describe a singte actual or } 
{ formal parameter. } 


TYPE 
iittfortfran_argument_desc = record 
argument_types titsfortran_argument_type, 


String_ftength? titSfortran_string_ftength, € onty used for type CHAR} 


argument_kinds !it$fortran_argument_kind, 


array_size: iit¢fortran_array_size, € onty used for kind DIMENSION} 


mode: titgargqument_usage, 
recend, 


titgfortran_argument_type = ()ic$fortran_ltogicat, jtic$fortran_integer, 


licsfortran_real,. tictfortran_doubte_real, tictfortran_complex,s 
tictfortran_char, tict$fortran_bootean, ticsfortran_null_tyoe), 


11tS$fortran_string_length = record 
adaptable? boolean, 
numbers 0 «2 OFfFF (16), 

recend, 


titsfortran_argument_kind = (licfortran_simple variable, 
lic$Sfortran_dimension,s tictfortran_external, 
lict¢fortran_subscripted var), 


{it?fortran_array_size = record 
adaptable: boolean, 
dimension: ost$segment_liengths 
recends, 


litSarqument_usage = (lictarcument_written, ticSeraqument_not_written) $ 


TYPE 
1ittbinding_temolate = record 
binding_offset:? titgsection_offset, 
case kind? fitf€binding_template_kind of 
= {ic$current_modute = 
section_ordinati: iit$section_ordinal, 
offset: iit$section_offsetf, 
internal_address? tittinternat_address_kind, 
= lic$external_ reference = 
name: omttprogram_name, 
address? !itS$address_kinds 
casend, 
recends 
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TYPE 
1itsbinding_template_kind = (fic¥current_module, tic$external_reference) $ 
TYPE 
1itgtransfer_symbo! = record 
names: omttprogram name, 
recend; 
TYPE 


1ittgopu_absotute = record 
executfes_on_any_ppu’s bootean, 
pou_numbers 0 «2 lictmax_ppu_number, 
foad_address: i!it$ppu_address, 
entry_address: titfopu_address,s 
text? array(€ * }] OF DBD e- OF FTFI165), 
recend$ 


{ tibrary header record 


TYPE 

tittidiorary_record = record 
names omt$program_name, (name of tibrary 
time_cresated: ost$time, 
date_created: ost$date, 
module_directory_index? integer, 
entry _point_directory_index: integer, 

recend; 


{module or entry point directory record 


TYPE 
1itgdirectory_item = record 
name? pomttorogram_name, Cname of module or entry point 
module_size? integer, C€size of modute (178 words) 
module_index: integer, frandom index of module 
recend; 
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